LEADTOOLS Image Processing (Leadtools.ImageProcessing.Color assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
ChangeHueSaturationIntensityCommand Constructor(Int32,Int32,Int32,ChangeHueSaturationIntensityCommandData[])
See Also  Example



hue
Angular amount to change the hue, in hundredths of a degree. Valid values range from -18000 through 18000. This value is divided internally by 100.
saturation
Percentage amount to change saturation, in tenths of a percent. Valid values range from -1000 through 1000. This value is divided internally by 10. Negative values decrease the saturation of colors. Positive values increase the saturation. The saturation level is increased or decreased by a percentage of its present saturation level. For example, an increase of 20 of the current saturation level "L" will raise the new saturation level "L1" to a value L = 0.20 * L. Likewise, increasing the saturation level 100 doubles the saturation level (L1 = L + 1.0 * L). Decreasing the saturation level 100 will set the new saturation level to 0. This process is carried out for every pixel. The saturation is set to 1000 (maximum value) if the new value exceeds 1000).
intensity
Percentage amount to change the intensity , in tenths of a percent. Valid values range from -1000 (black) through 1000 (white). This value is divided internally by 10. Positive values increase (or lighten) the brightness of the image. Negative values decrease (or darken) the brightness of the image.
data
An array of ChangeHueSaturationIntensityCommandData classes that provides information about the color ranges used by this method.
Initializes a new ChangeHueSaturationIntensityCommand class object with explicit parameters. Supported in Silverlight, Windows Phone 7

Syntax

Visual Basic (Declaration) 
Public Function New( _
   ByVal hue As Integer, _
   ByVal saturation As Integer, _
   ByVal intensity As Integer, _
   ByVal data() As ChangeHueSaturationIntensityCommandData _
)
Visual Basic (Usage)Copy Code
Dim hue As Integer
Dim saturation As Integer
Dim intensity As Integer
Dim data() As ChangeHueSaturationIntensityCommandData
 
Dim instance As New ChangeHueSaturationIntensityCommand(hue, saturation, intensity, data)
C# 
public ChangeHueSaturationIntensityCommand( 
   int hue,
   int saturation,
   int intensity,
   ChangeHueSaturationIntensityCommandData[] data
)
C++/CLI 
public:
ChangeHueSaturationIntensityCommand( 
   int hue,
   int saturation,
   int intensity,
   array<ChangeHueSaturationIntensityCommandData^>^ data
)

Parameters

hue
Angular amount to change the hue, in hundredths of a degree. Valid values range from -18000 through 18000. This value is divided internally by 100.
saturation
Percentage amount to change saturation, in tenths of a percent. Valid values range from -1000 through 1000. This value is divided internally by 10. Negative values decrease the saturation of colors. Positive values increase the saturation. The saturation level is increased or decreased by a percentage of its present saturation level. For example, an increase of 20 of the current saturation level "L" will raise the new saturation level "L1" to a value L = 0.20 * L. Likewise, increasing the saturation level 100 doubles the saturation level (L1 = L + 1.0 * L). Decreasing the saturation level 100 will set the new saturation level to 0. This process is carried out for every pixel. The saturation is set to 1000 (maximum value) if the new value exceeds 1000).
intensity
Percentage amount to change the intensity , in tenths of a percent. Valid values range from -1000 (black) through 1000 (white). This value is divided internally by 10. Positive values increase (or lighten) the brightness of the image. Negative values decrease (or darken) the brightness of the image.
data
An array of ChangeHueSaturationIntensityCommandData classes that provides information about the color ranges used by this method.

Example

Run the ChangeHueSaturationIntensityCommand on an image to change its hue, saturation, and brightness and change the red color to green.

Visual BasicCopy Code
Public Sub ChangeHueSaturationIntensityConstructorExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"))

   ' Prepare the command
   Dim Data() As ChangeHueSaturationIntensityCommandData
   ReDim Data(0)
   Data(0) = New ChangeHueSaturationIntensityCommandData(18000, 0, 0, 315, 45, 345, 15)
   Dim command As ChangeHueSaturationIntensityCommand = New ChangeHueSaturationIntensityCommand(0, 0, 0, Data)
   command.Run(leadImage)
   codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24)

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
public void ChangeHueSaturationIntensityConstructorExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"));

      // Prepare the command
      ChangeHueSaturationIntensityCommandData[] data = new ChangeHueSaturationIntensityCommandData[1];
      data[0] = new ChangeHueSaturationIntensityCommandData(18000, 0, 0, 315, 45, 345, 15);
      ChangeHueSaturationIntensityCommand command = new ChangeHueSaturationIntensityCommand(0, 0, 0, data);
      command.Run(image);
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24);

   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
SilverlightCSharpCopy Code
public void ChangeHueSaturationIntensityConstructorExample(RasterImage image, Stream outStream)
{
   // Prepare the command
   ChangeHueSaturationIntensityCommandData[] data = new ChangeHueSaturationIntensityCommandData[1];
   data[0] = new ChangeHueSaturationIntensityCommandData(18000, 0, 0, 315, 45, 345, 15);
   ChangeHueSaturationIntensityCommand command = new ChangeHueSaturationIntensityCommand();
   command.Data = data;
   command.Hue = 0;
   command.Intensity = 0;
   command.Saturation = 0;
   command.Run(image);

   // Save result image
   RasterCodecs codecs = new RasterCodecs();
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24);
   image.Dispose();
}
SilverlightVBCopy Code
Public Sub ChangeHueSaturationIntensityConstructorExample(ByVal image As RasterImage, ByVal outStream As Stream)
   ' Prepare the command
   Dim data As ChangeHueSaturationIntensityCommandData() = New ChangeHueSaturationIntensityCommandData(0){}
   data(0) = New ChangeHueSaturationIntensityCommandData(18000, 0, 0, 315, 45, 345, 15)
   Dim command As ChangeHueSaturationIntensityCommand = New ChangeHueSaturationIntensityCommand()
   command.Data = data
   command.Hue = 0
   command.Intensity = 0
   command.Saturation = 0
   command.Run(image)

   ' Save result image
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.Save(image, outStream, RasterImageFormat.Jpeg, 24)
   image.Dispose()
End Sub

Requirements

Target Platforms: Silverlight, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also